<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html4/loose.dtd">
<html lang="zh-CN"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta http-equiv="Content-Language" content="zh-CN"><link href="stylesheet.css" media="all" rel="stylesheet" type="text/css">
<title>函数易失性范畴</title>
<script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script>
</head><body class="SECT1">
<div>
<table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr><th colspan="5" align="center" valign="bottom">PostgreSQL 8.2.3 中文文档</th></tr>
<tr><td width="10%" align="left" valign="top"><a href="xfunc-overload.html" accesskey="P">后退</a></td><td width="10%" align="left" valign="top"><a href="extend.html">快退</a></td><td width="60%" align="center" valign="bottom">章33. 扩展 SQL</td><td width="10%" align="right" valign="top"><a href="extend.html">快进</a></td><td width="10%" align="right" valign="top"><a href="xfunc-pl.html" accesskey="N">前进</a></td></tr>
</table>
<hr align="LEFT" width="100%"></div>
<div class="SECT1"><h1 class="SECT1"><a name="XFUNC-VOLATILITY">33.6. 函数易失性范畴</a></h1><a name="AEN36486"></a><a name="AEN36489"></a><a name="AEN36491"></a><a name="AEN36493"></a>
<p>每个函数都有一个<i class="FIRSTTERM">易失性</i>级别(<tt class="LITERAL">VOLATILE</tt>, <tt class="LITERAL">STABLE</tt>, <tt class="LITERAL">IMMUTABLE</tt>)。如果 <a href="sql-createfunction.html"><i>CREATE FUNCTION</i></a> 命令没有明确声明范畴的话，<tt class="LITERAL">VOLATILE</tt> 就是缺省。易失性范畴是给优化器的一个关于函数行为的承诺：</p>
<ul>
<li><p><tt class="LITERAL">VOLATILE</tt> 可以做任何事情，包括修改数据库。它可以在使用同样参数调用时返回不同的结果。优化器对这样的函数不做任何假设。一个使用易失函数的查询在需要数据值的时候每次都重新计算函数的值。</p></li>
<li><p><tt class="LITERAL">STABLE</tt> 函数不会修改数据库，并且保证在同一个查询的环境里给出相同参数的情况下，会给出相同的结果。这个范畴允许优化器在一个查询里把多个函数调用优化成一个。特别是在索引扫描的条件表达式里面包含这样的函数是安全的。因为索引扫描只计算一次比较值，而不是每行一次。在索引扫描条件里使用一个 <tt class="LITERAL">VOLATILE</tt> 函数是非法的。</p></li>
<li><p><tt class="LITERAL">IMMUTABLE</tt> 函数不会修改数据库，并且保证在任何情况下同样的参数永远返回同样的结果。这个范畴允许优化器在查询调用函数的时候预先把函数计算成一个常量参数。比如，类似 <tt class="LITERAL">SELECT ... WHERE x = 2 + 2</tt> 的查询可以简化成 <tt class="LITERAL">SELECT ... WHERE x = 4</tt> ，因为在加法操作符下层的函数是标记为 <tt class="LITERAL">IMMUTABLE</tt> 的。</p></li>
</ul>
<p>为了最佳的优化结果，应该尽可能使用最严格的易失性范畴标记你的函数。</p>
<p>任何有副作用的函数都<span class="emphasis"><i class="EMPHASIS">必须</i></span>标记为 <tt class="LITERAL">VOLATILE</tt> ，这样对它的调用就不会被优化。即使一个函数没有副作用，但它的数值可能在一个查询里改变，那么也必须标记为 <tt class="LITERAL">VOLATILE</tt> ；例如 <tt class="LITERAL">random()</tt>, <tt class="LITERAL">currval()</tt>, <tt class="LITERAL">timeofday()</tt> 函数。</p>
<p>在那些简单的规划后马上执行的交互查询上，<tt class="LITERAL">STABLE</tt> 和 <tt class="LITERAL">IMMUTABLE</tt> 没有什么区别：函数是在规划开始时执行还是在查询开始时执行的差别并不大。但是如果规划被保存并且后来被重用，那差别可就大了。如果把一个函数标记为 <tt class="LITERAL">IMMUTABLE</tt> 而它实际上又不是，那么就会导致在随后使用其规划的时候用上一个不完整的数值。如果在使用预先准备好语句或者使用一种缓冲规划的函数语言(比如 PL/pgSQL)，那么后果可能很严重。</p>
<p>因为 MVCC 的快照行为(参阅<a href="mvcc.html">章12</a>)，一个只包含 <tt class="COMMAND">SELECT</tt> 命令的函数可以安全地标记为 <tt class="LITERAL">STABLE</tt> ，即使它所选择的表可能会被其它并发查询修改也一样。PostgreSQL 将会在执行 <tt class="LITERAL">STABLE</tt> 函数时为调用它的查询建立快照，因此它在该查询的生存期内都会看到一致的数据库视图。还要指出的是，<code class="FUNCTION">current_timestamp</code> 函数族都是稳定的，因为它们的数值在一个事务里是不改变的。</p>
<p>同样的快照行为也用于 <tt class="LITERAL">IMMUTABLE</tt> 函数里面的 <tt class="COMMAND">SELECT</tt> 命令。通常，在一个 <tt class="LITERAL">IMMUTABLE</tt> 函数里选择一个数据库的表是不明智的，因为如果表的内容改变，那么这种不变性就将改变。不过，PostgreSQL 并不禁止你这样做。</p>
<p>一个常见的错误是把一个函数标记为 <tt class="LITERAL">IMMUTABLE</tt> ，而实际上这个函数的结果依赖某个配置参数。比如，一个操作时间戳的函数可能有依赖于 <a href="runtime-config-client.html#GUC-TIMEZONE">timezone</a> 设置的结果。为了安全考虑，这样的函数应该标记为 <tt class="LITERAL">STABLE</tt> 。</p>
<div class="NOTE">
<blockquote class="NOTE">
<p><b>【注意】</b>在 PostgreSQL 8.0 之前，要求 <tt class="LITERAL">STABLE</tt> 和 <tt class="LITERAL">IMMUTABLE</tt> 函数不能修改数据库这个约束并未由系统强制。版本 8.0 通过要求这类函数不能包含 <tt class="COMMAND">SELECT</tt> 之外的 SQL 命令来强制这个约束。不过，这么做并不是完全防弹的升级，因为这样的函数仍然可以调用那些可能修改数据库的 <tt class="LITERAL">VOLATILE</tt> 函数。如果你这么做的话将会发现 <tt class="LITERAL">STABLE</tt> 或 <tt class="LITERAL">IMMUTABLE</tt> 并不会觉察到被它调用的函数对数据库所做的修改。</p>
</blockquote>
</div>
</div>
<div>
<hr align="LEFT" width="100%">
<table summary="Footer navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr><td width="33%" align="left" valign="top"><a href="xfunc-overload.html" accesskey="P">后退</a></td><td width="34%" align="center" valign="top"><a href="index.html" accesskey="H">首页</a></td><td width="33%" align="right" valign="top"><a href="xfunc-pl.html" accesskey="N">前进</a></td></tr>
<tr><td width="33%" align="left" valign="top">函数重载</td><td width="34%" align="center" valign="top"><a href="extend.html" accesskey="U">上一级</a></td><td width="33%" align="right" valign="top">过程语言函数</td></tr>
</table>
</div>
</body></html>